home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr48 / pavt117.zip / QUERIES.DOC < prev    next >
Text File  |  1993-04-24  |  3KB  |  77 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                       Avatar level 1 console
  7.               Valid query types and their responses
  8.                        An Informal Document
  9.  
  10.  
  11.  
  12.     I never did see any documentation  on the  different types  of 
  13.     queries  which  can  be  made  by  the  AVT/1  query (^V^Q<q>) 
  14.     command.   That  is why  I took  the time  to experiment  with 
  15.     avatar.sys and come up with the following list of queries:
  16.  
  17.     All  of  these  are  prefaced  (naturally)  by the  ^V^Q query 
  18.     command and the byte  which follows  determines the  response.  
  19.     If the parser is in Cooked mode the  responses will  be cooked 
  20.     where appropriate.
  21.  
  22.     ^A and ^B --  These return  a valid  set attribute  command in 
  23.     the form of ^V^A<a>.
  24.  
  25.     ^H --   This one  returns an  appropriate set  cursor position 
  26.     command  to  indicate  the  current  cursor   position.   (ex: 
  27.     ^V^H^A^A)
  28.  
  29.     ^Q -- This query is the best known.  It returns a string  with 
  30.     the  following  format: "AVTn,  Copyright or  program info+^M" 
  31.     Where n  is a  0 or  a 1  depending upon  the level  of avatar 
  32.     completely supported. (0 means  level 0+,  not level  0).  The 
  33.     copyright  or  program info  is basically  junk unless  you're 
  34.     really  interested  in  what  program the  remote terminal  is 
  35.     running.
  36.  
  37.     ^V  --  This  returns  the appropriate  define window  command 
  38.     describing the active window. (ex: ^V^V#0^G^A^A^Y#80)
  39.  
  40.     ^W -- This command, similar to the last,  return a  set window 
  41.     command to indicate the current window. (ex: ^V^W#0)
  42.  
  43.     FS,GS (Ascii 28,29) --  These queries  indicate wether  or not 
  44.     the interpreter is asleep or not.  They return either a  go to 
  45.     sleep or wake up command.  (ex: ^VGS when awake)
  46.  
  47.     RS,US (Ascii 30,31) --  These two  queries return  the current 
  48.     status of vertical mode for the current window.   As with  all 
  49.     the queries, they return the avatar command capable of setting 
  50.     the current mode.
  51.  
  52.     '#','"','$'  --   Like  the  last  ones,   these  return   the 
  53.     appropriate command to set the end of line wrap mode.   (none, 
  54.     normal, zigzag).
  55.  
  56.     '%','&' -- These two return the status of  line feeds.   (move 
  57.     up or move down).
  58.  
  59.     '(',')' -- These return wether or not we are in reverse mode.
  60.  
  61.     ':'  --  This  returns  the  current  keyboard mode  through a 
  62.     command (ex: ^V:0)
  63.  
  64.     '='  --   This  is  an  important  one for  the server  to pay 
  65.     attention to as the remote terminal  get's the  final decision 
  66.     on wether or not it stays  in cooked  mode.  This  returns the 
  67.     command to set the parser into cooked or raw mode.
  68.  
  69.     If  you  haven't noticed,  the query  types all  correspond to 
  70.     their  avatar  command.  They  also return  a complete  Avatar 
  71.     command  to  the server.   Currently I  wouldn't expect  every 
  72.     AVT/1 console to know about these queries, but  hopefully this 
  73.     document will help fix that problem.
  74.  
  75.  
  76.                                   Greg Smith
  77.